home *** CD-ROM | disk | FTP | other *** search
/ Mac Expert 1995 Winter / Mac Expert - Winter 95.iso / Les fichiers / Utilitaires divers / Images / RTrace 1.0 ƒ / RTrace-docs / RTrace-Manual-intro < prev    next >
Encoding:
Text File  |  1992-11-10  |  7.7 KB  |  144 lines  |  [ttro/ttxt]

  1.                                 
  2.                                               RTrace 1.0
  3.                                          by Antonio Costa
  4.  
  5.                            Mac Port by Reid Judd and Greg Ferrar
  6.  
  7. Introduction
  8.  
  9. A Brief Description of RTrace
  10.  
  11. RTrace is a full-featured Ray Tracing program for the Macintosh computer.  It can generate both still images and animation sequences.
  12. System Requirements
  13.  
  14. RTrace will work on any Macintosh running 6.0.4 or later.  Its preferred setup is:
  15.  
  16.    •    Fast Macintosh (68020 or better)
  17.    •    Math Coprocessor
  18.    •    4 Meg RAM
  19.    •    32-bit QuickDraw
  20.    •    System 7
  21.    •    QuickTime
  22.  
  23. However, it will run on a 68000-based Macintosh without a Math Coprocessor, 32-bit QuickDraw, or System 7, and it can run in as small as a 500K partition.
  24.  
  25. On a 68000-based Macintosh, or on a Macintosh without a Math Coprocessor, you should use the application called “RTrace/68000.”  Otherwise, use the application called “RTrace.”  From now on, both programs will be referred to as “RTrace.”
  26.  
  27. On a Macintosh with only 8-bit Color QuickDraw, RTrace will run, but you will not be able to use the Clipboard to copy images from the Image Window, and the Image Window will not be updated.  On a Macintosh with 1-bit (Original) QuickDraw, the image window will not appear at all.
  28.  
  29. RTrace does not require System 7, but it takes advantage of some of System 7’s features if they are present.  It also will take advantage of QuickTime, if it is present.
  30.  
  31. A Brief Description of Ray Tracing
  32.  
  33. Ray Tracing is a process which generates a realistic image from a mathematical description of a scene.  It is called “Ray Tracing” because it generates these images by tracing the paths that an actual light ray would take in the scene.  By mathematically tracing the paths of thousands of light rays, a ray tracing program is able to create a photographic three-dimensional image of a scene.  Since generating a single ray-traced image can take hundreds of thousands of complex mathematical operations, ray-tracing is a slow process.  On a very fast Macintosh, images will be generated fairly quickly.  However, if you are using a slower Macintosh (like a Mac Plus), be prepared to wait a long time.
  34.  
  35. The Fine Print
  36.  
  37. RTrace is absolutely free!!!   The only requirements are that you not sell it, or distribute it without its documentation.  RTrace may not be distributed with any collection of shareware or freeware without the written consent of the authors.  However, we’d like to see this program spread as far as possible, so please do contact one of us if such distribution is desired.
  38.  
  39. About the Authors
  40.  
  41. The original author of RTrace is Antonio Costa, who wrote it for Unix, Vax, PC's, and other systems.  The Macintosh port was made by Reid Judd.  Greg Ferrar wrote most of the Macintosh user interface, and Reid Judd wrote the rest.
  42.  
  43. Contacting the Authors
  44. Antonio Costa may be contacted:    
  45.     by email at acc@asterix.inescn.pt.
  46.     by “snail mail” at
  47.          INESC        
  48.        Largo Mompilher 22        
  49.        4100 Porto PORTUGAL
  50.     or by telephone at +351+02+321006
  51.  
  52. Reid Judd may be contacted:
  53.     by email at ILLUMINATI@AppleLink.Apple.COM.
  54.     by “snail mail” at
  55.          ILLUMINATI        
  56.          2617 Sweetbriar Road        
  57.          Durham, NC  27704
  58.     or by telephone at (919)-683-2424
  59.  
  60. Greg Ferrar may be contacted:    
  61.     by email at gregt@function.mps.ohio-state.edu,
  62.     by “snail mail” at
  63.          2300 North High Street        
  64.          Columbus, OH   43202-2902,
  65.     or by telephone at (614) 267-8754
  66.  
  67. Hopes for the Future
  68.  
  69. RTrace is far from done.  We had to stop somewhere, so here’s Version 1.0.  Here’s a sampling of what we have in mind for later versions:
  70.  
  71. •    Support for more powerful animation.  In other words, it will be possible to have objects in the scene move, rotate, contort..whatever you want.  Animation is currently limited to changing the viewpoint to fly around or through an unmoving scene.
  72.  
  73. •    Converters to/from popular modeling and rendering packages so that RTrace may import scene data files in much the same way Macintosh word processors can import text files.
  74.  
  75. •    Powerful System-7 features.  We hope to eventually separate the ray-tracing part from the interface part, so you can run the math-intensive code on a powerful computer while you use the interface on another (networked) computer.
  76.  
  77. •    And much, much more!
  78. All we can do right now is guess what our users will want.  If you have suggestion, let us know!  RTrace will be an ongoing project.  If you're a programmer with access to Think C and would like to donate time and energy to make this program even better, please contact us.  And if you have a bug report, please let us know!
  79.  
  80.  
  81. Getting Later Versions of RTrace
  82.  
  83. The latest version of RTrace will always be available from asterix.inescn.pt via anonymous ftp, in the /pub/RTrace directory.  The Macintosh version will be located in the file(s) in /pub/RTrace/Macintosh/rtrace*.hqx.
  84.  
  85. A Message from the Author
  86.  
  87. Here is the README file which is distributed with the unix version of RTrace, written by Antonio Costa.  Let’s have a big hand for Antonio for writing this fabulous ray-tracer and donating it to the world!
  88.  
  89. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  90. This represents the 7th formal release of the `rtrace' Raytracer.  It was written to help me understand how raytracing works, to generate cute images, and generally because I like to program.  Feel free to use it for any purpose, I am releasing it into the public domain.
  91.  
  92. The input format to this ray tracer is called "SFF" or Simple File Format, after using "NFF" or Neutral File Format, which was invented by Eric Haines' for his Standard Procedural Database.  The SPD was designed to allow programmers to test their raytracers on databases of varying sizes.  While not the end-all to object file formats, it has served me well.
  93.  
  94. If anyone uses or wants to use NFF, I can send a NFF to SFF converter.
  95.  
  96. SFF supports the following concepts and primitives:
  97.  
  98.    •    point lights
  99.    •    directional lights
  100.    •    spot lights with fall-off
  101.    •    extended lights
  102.    •    2 ways of defining surfaces
  103.    •    spheres
  104.    •    axis-aligned parallelepipeds
  105.    •    cylinders
  106.    •    cones
  107.    •    bicubic patches
  108.    •    polygons
  109.    •    polygonal patches (normals are interpolated from corner points)
  110.    •    3D text with high quality
  111.    •    CSG operations
  112.    •    4x4 matrix transformations
  113.    •    textures
  114.    •    depth of field
  115.    •    diffuse distribution
  116.    •    stereoscopic pair creation
  117.  
  118. The `rtrace' raytracer supports all of these primitives, with the minor limitation that polygonal patches must be triangles (have only three vertices).
  119.  
  120. Procedural textures (with 4x4 matrix transformations) are also supported:
  121.  
  122.    •    checkerboard
  123.    •    color blotches
  124.    •    marble
  125.    •    bump map
  126.    •    fbm
  127.    •    fbm bump map
  128.    •    wood
  129.    •    gloss
  130.    •    image mapping
  131.    •    waves
  132.    •    (and many others...)
  133.  
  134. The output from the raytracer is very simple, and not directly tied to any specific device.   It consists of a single line, with format in C style of "%c%c%c%c", which gives the resolution of the image (Width LSByte, Width MSByte, Height LSByte, Height MSByte).  It is then followed by Width*Height sets of (red green blue) bytes.
  135.  
  136. I have lots of filters source code for displaying the ".pic" files, as well as interesting objects that I run across.  Filters already exist to display images on Suns, to convert to PostScript, as well as X11 bitmaps for xwud.
  137.  
  138. I advise you to get a package called the "Fuzzy Bitmap Package" (FBM), that has lots of useful programs for simple image processing, conversion, etc. The author is Michael Mauldin <mlm@nl.cs.cmu.edu>.  The Utah Raster Toolkit is also a very good graphics package.  Also good is Eric Haines' SPD source code, so you can generate your own fractal spheres, mountains, gears, etc.
  139.  
  140. Also thanks to the numerous authors whose research into raytracing has seen implementation in this raytracer.
  141.  
  142.    Antonio Costa.
  143.  
  144.